home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / fondir55.arc / FONDIR.DOC < prev    next >
Text File  |  1990-09-05  |  58KB  |  1,551 lines
  1.  
  2. ╔═══════════════════════════════════════════════════════════════════════╗
  3. ║                                                                       ║
  4. ║      ╔═══  ╔══╗  ╔╗  ╗  ╔══╗   ═╦═  ╔══╗           User's Guide       ║
  5. ║      ╠═══  ║  ║  ║╚╗ ║  ║  ╚╗   ║   ║  ╚╗          to Operation       ║
  6. ║      ║     ║  ║  ║ ╚╗║  ║   ║   ║   ╠═╦═╝                             ║
  7. ║      ╚     ╚══╝  ╚  ╚╝  ╚═══╝  ═╩═  ╚ ╚══                             ║
  8. ║                                                                       ║
  9. ║                                                                       ║
  10. ║       FONDIR - BBS Text File to Phone Directory Translate Utility     ║
  11. ║      Copyright (C) 1988-1990 Henry C. Clark, All rights reserved.     ║
  12. ║                                                                       ║
  13. ╚═══════════════════════════════════════════════════════════════════════╝
  14.  
  15.  
  16.                           Software Mechanics
  17.                            P.O. Box 832052
  18.                          Richardson, TX 75083
  19.  
  20.           214-881-2627  12/24/96/14400 bps  24hr  FIDO 1:124/6119
  21.  
  22.  
  23.  
  24. ╔═══════════════════════════════════════════════════════════════════════╗
  25. ║ WHATS NEW                                                             ║
  26. ╚═══════════════════════════════════════════════════════════════════════╝
  27.  
  28. FONDIR Version 5.5 implements support for Qmodem 4.2 and Commo 4.3.
  29.  
  30. Also, a bug was corrected where the decimal number fields in the BBS list
  31. were not correctly imported into the phone directories.
  32.  
  33. Enjoy.
  34.  
  35.  
  36. ╔═══════════════════════════════════════════════════════════════════════╗
  37. ║ TABLE OF CONTENTS   FONDIR Version 5.5                                ║
  38. ╚═══════════════════════════════════════════════════════════════════════╝
  39.  
  40. Chap.  1 -- FONDIR ARCHIVE.
  41.   Installation
  42.   Overview
  43.   History
  44.  
  45. Chap.  2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM.
  46.   Quick Start Section
  47.   Fondir Uses Default Directory Name
  48.   Fondir Renames Existing Directory File
  49.  
  50. Chap.  3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST.
  51.   Fondir Appends To Existing BBS List
  52.  
  53. Chap.  4 -- ONLINE HELP.
  54.  
  55. Chap.  5 -- THE COMMAND LINE OPTIONS.
  56.   Comm Program type   ( /o: option )
  57.   Assume Protocol     ( /p: option )
  58.   Keep Date           ( /k  option )
  59.   Local Area Code     ( /l: option )
  60.   Prefix Phone Number ( /a: option )
  61.   Metro Number        ( /d: option )
  62.   Format Specification Key Character ( /c  option )
  63.   Modem Speed         ( /m  and /b  options )
  64.   Export              ( /x  option )
  65.  
  66. Chap.  6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES.
  67.   Transform Example
  68.   Error Checking of Input ( semantic )
  69.   Error on Input ( logical )
  70.  
  71. Chap.  7 -- BBS LIST FORMAT SPECIFICATIONS.
  72.   Format Specification Coding
  73.   Format Specifier Stacking
  74.   Format First Word Length
  75.   Format Header Specification
  76.   Comm Program Field Support
  77.  
  78. Chap.  8 -- BBS LIST CONTENTS
  79.   Protocol Field Format
  80.   The Bps Modem Rate
  81.   Modem Type
  82.   Parity Indicator
  83.   File Transfer Protocol Type
  84.   Terminal Emulator Mode Codes
  85.   Examples of BBS Lists
  86.  
  87. Chap.  9 -- PROGRAM SWITCHES AND DEFAULTS.
  88.   Comm Program Type Codes
  89.   Speed Code Parameters
  90.   Warnings and Other Notes
  91.  
  92. Chap. 10 -- REGISTER TO GET UPDATES.
  93.   Mail-in Registration Form
  94.  
  95. Chap. 11 -- LICENSE AGREEMENT.
  96.   The Terms of The Agreement
  97.   Note from the Author
  98.  
  99.  
  100.  
  101. ╔═══════════════════════════════════════════════════════════════════════╗
  102. ║ 1 -- FONDIR ARCHIVE                                                   ║
  103. ╚═══════════════════════════════════════════════════════════════════════╝
  104.  
  105. FONDIR is shipped in an archive file, FONDIRxx.ZIP.  The 'xx' is the
  106. version number.  The archive file should contain the following files :
  107.  
  108.    FONDIR.EXE          - 8088 compatible version,
  109.    FONDIR.DOC          - this document file you're reading now,
  110.    FONERR.DOC          - list of displayed output from FONDIR operations
  111.                          meaning and possible solutions to problems
  112.    METRO.214           - sample DFW 214 metro exchange list,
  113.    LDAREA.214          - sample Dallas 214 long distance exchange list,
  114.    METRO.817           - sample DFW 817 metro exchange list,
  115.    COMCOL.EXE          - program to convert comma separated files to
  116.                          the columnar format used by FONDIR,
  117.    COMCOL.DOC          - document for that program.
  118.  
  119.    Specify when you register that you want the sixteen bit versions.
  120.  
  121.  
  122. ┌───────────────────────────────────────────────────────────────────────┐
  123. │ OVERVIEW                                                              │
  124. └───────────────────────────────────────────────────────────────────────┘
  125.   
  126.  
  127. FONDIR will convert a text list of BBS phone numbers, names and other
  128. information into a file which can be used by your Comm Program. You
  129. may have to add control codes to the text list to show FONDIR where
  130. the information is.
  131.  
  132. FONDIR can also convert back to a text list format from your Comm
  133. Program phone directory file.
  134.  
  135.   BBS List -> FONDIR Import -> Comm Program directory file
  136.   Comm Program directory file -> FONDIR Export -> BBS List
  137.  
  138. COMCOL will convert a text file with comma separated fields to a
  139. vertical column field text file.  There is a separate document
  140. covering that program.  FONDIR likes columns of data.
  141.  
  142.  
  143. ┌───────────────────────────────────────────────────────────────────────┐
  144. │ INSTALLATION                                                          │
  145. └───────────────────────────────────────────────────────────────────────┘
  146.  
  147. FONDIR is short for Phone Directory. Un-zip the FONDIRxx.ZIP file and
  148. either :
  149.  
  150.   a.) keep the .exe program and exchange lists
  151.       with your BBS list files, or
  152.   b.) keep the .exe program and exchange lists
  153.       with your Comm Program files.
  154.  
  155. FONDIR will work from a pathed sub-directory, but the exchange lists,
  156. BBS list file and Comm Program file are read/written from the current
  157. directory.
  158.  
  159.  
  160.  
  161. ┌───────────────────────────────────────────────────────────────────────┐
  162. │ HISTORY                                                               │
  163. └───────────────────────────────────────────────────────────────────────┘
  164.   
  165.  
  166. FONDIR, Version 5.5 is the result of continual upgrades, including :
  167.  
  168.      as BF.EXE ( Boyan Phone )
  169.    V 1.0a  initial release, options h,s,n,p,b,m,d, CARR to BOYAN
  170.    V 1.1a    correct 9600 bps value for BOYAN
  171.  
  172.      as XLATE.EXE ( Translate )
  173.    V 2.0a  add procomm 2.4.2, procomm plus, qmodem, gt-powercomm, telix
  174.    V 3.0b  corrected gt-power headers, added options x, k
  175.    V 3.1b   on /b set speed option, move speed text into name area at end
  176.    V 3.2   correct end of gt file handling, pibterm support ( /o:I )
  177.    V 3.3   correct less than 8 char phone number length
  178.    V 3.4   new BBS list system name formats
  179.  
  180.      as FONDIR.EXE ( "Phone Dear" )
  181.    V 4.0a  any list using format specification, /l, /a area code options
  182.    V 4.1a  gt v.14, format codes for elapse, upload, download
  183.    V 4.2   telix 3, pibterm 4.1
  184.    V 4.3a  metro number support
  185.    V 4.4   Boyan 4 support, any two metro areas, Qmodem 4.0 support
  186.    V 4.5   gt 1500, area headers, stacked format fields
  187.    V 4.6   telemate 1.10
  188.    V 4.7   telemate memo & passwords, blank field bug fix, Zmodem default
  189.    V 4.8   telix export bug fix, /x:dirfile name option
  190.    V 4.9   Qmodem index number bug fix
  191.    V 5.0   PC-Talk4, Rcomm, K9-Express support, 80 exchange tables
  192.    V 5.1   Mirror 3 support
  193.    V 5.2   telemate 2.0, PC Anywhere 3.11, Carbon Copy Plus 4.01,
  194.            |g logfile key, |i port key
  195.    V 5.3   gt-15.50, MSC 6.0, remove 's' functions, first word on
  196.            file names
  197.    V 5.4   ADialer 2.0, remove duplex, fix telemate speed code
  198.    V 5.5   Commo 4.3, Qmodem 4.2, fix count truncate bugs
  199.  
  200.  
  201.  
  202. ╔═══════════════════════════════════════════════════════════════════════╗
  203. ║ 2 -- HOW TO IMPORT A BBS LIST TO YOUR PROGRAM                         ║
  204. ╚═══════════════════════════════════════════════════════════════════════╝
  205.  
  206.  
  207. ┌───────────────────────────────────────────────────────────────────────┐
  208. │ QUICK START SECTION                                                   │
  209. └───────────────────────────────────────────────────────────────────────┘
  210.  
  211.  
  212. Most BBS lists are distributed in text file format.  The list entries
  213. are arranged 'one BBS system per line of text', and the data for each
  214. BBS is arranged in columnar format.
  215.  
  216. FONDIR will convert a BBS list text file to the binary file that your
  217. Comm Program uses in it's dialing directory.
  218.  
  219. For example, let's suppose you have a BBS list file, and each line of
  220. data looks something like this :
  221.  
  222. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  223. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  224. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  225.  
  226. You need to add a set of codes to the list file so that FONDIR knows
  227. where the information about each BBS system is :
  228.  
  229. |d5   |n20                 |f4   |#12          |p2 |i11
  230.  
  231. 03/24 MY BBS               OPUS  214-881-2627  #Z  Henry Clark
  232. 03/24 Joe's BBS            OPUS  214-555-1234  #Z  Joe Modem  
  233. 03/24 RBBS Central         RBBS  900-555-0000  #Y  Huck Finn  
  234.  
  235. The codes ( for Format Specification ) I have used include the
  236. date last called ( |d ), the BBS system name ( |n ), a Script
  237. File name ( |f ), the phone number ( |# ) and some protocol
  238. codes ( |p ) and an information field ( |i ).
  239.   
  240. After each code letter is the width of each columnar field.
  241.  
  242. Given the above two lines in a file called BBS.LST, I could then
  243. create a Comm Program directory file, for example the Boyan Version 4
  244. BOYAN.FON file, with the DOS command :
  245.  
  246. C:>fondir bbs.lst /o:b /k
  247.  
  248. That's all there is to it.  A BOYAN.FON file, ready to be used by the
  249. Boyan Comm Program, will be created in the current directory.
  250.  
  251.  
  252. ┌───────────────────────────────────────────────────────────────────────┐
  253. │ MORE DETAIL ABOUT FONDIR IMPORT                                       │
  254. └───────────────────────────────────────────────────────────────────────┘
  255.   
  256.  
  257. I don't know which Comm Program you use.  I do know that the /o:
  258. option is REQUIRED.  You must use the /o: option to tell FONDIR which
  259. Comm Program you use. You must figure out which /o:  option is for
  260. your Comm Program.
  261.  
  262. Target phone directory filenames :
  263.  
  264. "BOYAN.FON"               use the  /o:b  option  Boyan
  265. "PROCOMM.DIR"             use the  /o:p  option  Procomm
  266. "PCPLUS.DIR"              use the  /o:+  option  Procomm Plus
  267. "QMODEM.FON"              use the  /o:q  option  Qmodem
  268. "GT.DIR"                  use the  /o:g  option  GT Powercomm
  269. "TELIX.FON"               use the  /o:t  option  Telix
  270. "PIBTERM.FON"             use the  /o:i  option  Pibterm
  271. "TM.FON"                  use the  /o:m  option  Telemate * See note below
  272. "PC-TALK4.DIR"            use the  /o:c  option  PC-Talk
  273. "PC-TALK.DIR"             use the  /o:r  option  Rcomm
  274. "K9X.P"                   use the  /o:k  option  K9 Express
  275. "DIALDIR.DAT"             use the  /o:o  option  Mirror
  276. "DIALDIR.PRM"             use the  /o:a  option  PC Anywhere
  277. "CC30.CFG"                use the  /o:y  option  Carbon Copy
  278. "BBS.DAT"                 use the  /o:d  option  A Dialer
  279. "COMMO.FON"               use the  /o:f  option  Commo
  280.  
  281.  
  282. "Boyan, Procomm, Procomm +, Qmodem, Gt-Powercomm, Telemate, Telix,
  283. Pibterm, PC-Talk4, Rcomm, K9-Express, Mirror 3, PC Anywhere,
  284. Carbon Copy Plus, A Dialer and Commo"...
  285.  
  286.   ...are all Copyrighted by their respective authors.
  287.  
  288. In general, the contents of the phone file reflect your programs
  289. dialing directory information.  The above file names are the
  290. defaults for your Comm Programs.
  291.  
  292. * File create name note :
  293.  
  294. For Telemate, when using the System ID ( |i ) specification, a file
  295. called "TM.MEM" is created.  This is the Telemate memo file and it's
  296. contents is seen in the online dialing directory.  FONDIR refers to
  297. it as the 'auxilary' file.
  298.  
  299.  
  300. ┌───────────────────────────────────────────────────────────────────────┐
  301. │ FONDIR USES DEFAULT DIRECTORY NAME.                                   │
  302. └───────────────────────────────────────────────────────────────────────┘
  303.   
  304.  
  305. FONDIR always uses the above file names, and they are assumed to be
  306. in your current directory. It is an ERROR to enter a file name of
  307. these types as a parameter for FONDIR.  You specify one of the file
  308. names above using the /o:? parameter.  The valid characters for the
  309. '?' are shown above.
  310.  
  311. FONDIR is going to convert from the text file to the Comm Program
  312. directory file, or vice versa.  You specify the Comm Program
  313. type with the /o:? option, and you specify the BBS List text file name
  314. explicitly.
  315.  
  316.  
  317. ┌───────────────────────────────────────────────────────────────────────┐
  318. │ FONDIR RENAMES EXISTING DIRECTORY FILE.                               │
  319. └───────────────────────────────────────────────────────────────────────┘
  320.   
  321.  
  322. When FONDIR is going to write a directory file with one of the above
  323. names, AND that file already EXISTS : FONDIR will rename the existing
  324. file by changing the last letter of the 'filename' part of the
  325. complete file name to a unique number.  For example, BOYAN.FON might
  326. become BOYA1.FON.
  327.  
  328. This technique is used when the BBS list contains more entries than
  329. the Comm Program file will support.  FONDIR will continue to rename
  330. the file to a unique name, for each directory file that is necessary
  331. to COMPLETELY convert the BBS list.  For example, you might end up
  332. with the following files, ( again, I'll use the BOYAN.FON example ) :
  333.  
  334.    boyan.fon   - the last file
  335.    boya1.fon   - the first file ( assuming none existed previously )
  336.    boya2.fon   - the second file ( second set of entries )
  337.    etc.
  338.  
  339. There are two ways to use these 'numbered' files.  The first is to
  340. simply copy it to the actual name required by your Comm Program.  The
  341. second way is to use your Comm Program's "select phone directory
  342. file" option, many Comm Programs support this function.
  343.  
  344. Any auxilary file generated will follow this same naming convention.
  345.  
  346. WARNING : the maximum number of BBS list entries supportable is
  347. dependent upon the number of entries per file your Comm Program
  348. supports.  If FONDIR has to create more than 10 directory files,
  349. the numbering system will fall into the characters which logically
  350. follow the '9' character;  this is not fatal, just be sure to watch
  351. the file names to get the idea.  After '9' comes '@', then 'A', 'B',
  352. etc.
  353.  
  354.  
  355. ┌───────────────────────────────────────────────────────────────────────┐
  356. │ USAGE EXAMPLE ( Import BBS list to Comm Program ).                    │
  357. └───────────────────────────────────────────────────────────────────────┘
  358.   
  359.  
  360. The following command is an example.  To convert to Boyan 4.0 :
  361.  
  362.  FONDIR bbslist.txt /o:b
  363.         ^           ^
  364.         |           |
  365.         |           |
  366.         |           |
  367.         |           `-  translate to the Boyan format
  368.         `-  translate from this BBS list file
  369.  
  370. The BBS list file must contain a Format Specification which FONDIR
  371. uses to determine how the data in the list file is organized.  YOU
  372. MUST MANUALLY enter the specification if it is not already there.
  373. See Chapter 7 for more information on the Format Specification.
  374.        
  375. Register if you want custom Comm Program translations.
  376.  
  377.  
  378.  
  379. ╔═══════════════════════════════════════════════════════════════════════╗
  380. ║ 3 -- HOW TO EXPORT FROM YOUR PROGRAM TO A BBS LIST                    ║
  381. ╚═══════════════════════════════════════════════════════════════════════╝
  382.  
  383. The idea of exporting TO a BBS list text file from your program phone
  384. directory is to support the changes you are still making manually, so
  385. that you don't have to enter them again every time a BBS list
  386. changes.  The Export feature is also useful for translating between
  387. two or more Comm Programs.
  388.  
  389. The BBS list file must contain a Format Specification.  See Chapter 7
  390. for more information on the Format Specification.
  391.  
  392. For example purposes, create a text file called BBSLIST.TXT with
  393. the following line in it :
  394.  
  395. |d5   |n20                 |#12          |p4
  396.  
  397. Make sure your text file does NOT contain a CONTROL-Z ( ascii EOF ),
  398. such as DOS EDLIN would generate.
  399.  
  400. The FONDIR export command has three parameters :
  401.  
  402.   FONDIR bbslist.txt /o:b /x
  403.          ^           ^    ^
  404.          |           |    |
  405.          |           |    `------  the export option
  406.          |           `--------- the program type Boyan option
  407.          `------------------ a BBS text file to write to
  408.  
  409. The above command will append list information from your Boyan
  410. program phone file directory ( boyan.fon ), to a file called 
  411. "bbslist.txt" which would look like this :
  412.  
  413. |d5   |n20                 |#12          |p4
  414.  
  415. 03/24 MY BBS               214-881-2627  #Z
  416. 03/24 Joe's BBS            214-555-1234  #Z
  417. 03/24 RBBS Central         900-555-0000  #Y
  418.   
  419. You can specify WHICH Comm Program directory file to export using the
  420. option /x:filename format.  See the /x option description for more
  421. information.
  422.  
  423.  
  424. ┌───────────────────────────────────────────────────────────────────────┐
  425. │ FONDIR APPENDS TO EXISTING BBS LIST.                                  │
  426. └───────────────────────────────────────────────────────────────────────┘
  427.   
  428.  
  429. FONDIR always writes it's export text to the file name given.  It
  430. does NOT overwrite an existing text file of that name, it adds it's
  431. export data to the end of existing data.  These are also called
  432. 'append' writes.
  433.  
  434.  
  435.  
  436.  
  437. ╔═══════════════════════════════════════════════════════════════════════╗
  438. ║ 4 -- ONLINE HELP                                                      ║
  439. ╚═══════════════════════════════════════════════════════════════════════╝
  440.  
  441. You can get the following help information by entering the FONDIR
  442. command with NO parameters, with the /h parameter, or with the /?
  443. parameter.
  444.  
  445.  Command format is  >FONDIR  bbslist.fil  /o:x  [options]
  446.  
  447.   /o:x   - x is Comm Program, one of B P + Q G T I M C R K O A Y D or F.
  448.     Boyan,Procomm,procomm+,Qmodem,Gt-power,Telix,pIbterm,teleMate
  449.     pC-talk4,Rcomm,K9-express,mirrOr3,pcAnywhere,carboncopY,aDialer,
  450.     Commo
  451.  OPTIONS :
  452.   /m:n     - max modem speed       /b:n    - speed always : 3,1,2,4,9,a,b
  453.   /k       - keep dates            /p:c    - protocol always 'c'
  454.   /l:ddd   - LOCAL area code ddd   /d:ddd.. - METRO exchange area code ddd
  455.   /a:ddd.. - prefix LD phone numbers with ddd...
  456.   /c:c     - BBS list format key character, default '|'
  457.   /x:dirname - Export to BBS list, default is Import from BBS list
  458.  
  459.  Separate options with a space. See docs for list format specifiers.
  460.    EXAMPLE :   FONDIR bbs.lst /o:b /k /l:214 /d:817 /a:1-
  461.  
  462.  24hr. Help/Register at   124/6119   MY BBS   214-881-2627.
  463.  
  464.  
  465.  
  466.  
  467. ╔═══════════════════════════════════════════════════════════════════════╗
  468. ║ 5 -- THE COMMAND LINE OPTIONS                                         ║
  469. ╚═══════════════════════════════════════════════════════════════════════╝
  470.  
  471. ┌───────────────────────────────────────────────────────────────────────┐
  472. │ COMM PROGRAM TYPE ( /o:  option ).                                    │
  473. └───────────────────────────────────────────────────────────────────────┘
  474.  
  475.  
  476. It's required and fully described in Chapter 2, section More Detail
  477. on Import.
  478.  
  479.  
  480.  
  481. ┌───────────────────────────────────────────────────────────────────────┐
  482. │ ASSUME PROTOCOL ( /p:   option ).                                     │
  483. └───────────────────────────────────────────────────────────────────────┘
  484.   
  485.  
  486. If you specify a protocol using the /p option, then FONDIR will
  487. always set the protocol in each phone directory entry to the letter
  488. you specify in the /p option.
  489.  
  490. In the absence of the /p option, FONDIR will use the Format
  491. Specification for PROTOCOL Code ( |p5 ), as you specified in the text
  492. file, and look there for a file transfer protocol code.  The codes
  493. are defined in
  494.  
  495.  
  496. ┌───────────────────────────────────────────────────────────────────────┐
  497. │ KEEP DATE ( /k  option ).                                             │
  498. └───────────────────────────────────────────────────────────────────────┘
  499.   
  500.  
  501. If you want to update the date of last call in your Comm Program
  502. phone file directory, then use the /k option.  If you do NOT use the
  503. /k option, then your phone file directory will contain a blank date.
  504.  
  505. In a special case, a Qmodem 4.2 entry will contain the date that
  506. FONDIR created the FON directory.
  507.  
  508.  
  509. ┌───────────────────────────────────────────────────────────────────────┐
  510. │ LOCAL AREA CODE ( /l:   option ).                                     │
  511. └───────────────────────────────────────────────────────────────────────┘
  512.   
  513.  
  514. The phone numbers in a BBS list are best kept as full 10 digit phone
  515. numbers.  Like this : 214-881-2627.
  516.  
  517. They do NOT have to be this way, but the FONDIR /l, /d and
  518. /a options function best. For your local calls, area code dialing
  519. will not be required.  The /l: option allows you to specify which
  520. area code is your local area code, and FONDIR will remove the area
  521. code digits from the phone number in the text list entry.
  522.  
  523. See Chapter 7 for |L format options that allow use of 7 digit numbers
  524. in the list, with an area code 'header'.
  525.  
  526. For example, if you live in the 214 area code, you may want to use
  527. the option /l:214-   to remove ONLY those digits from the start of
  528. a phone number.
  529.  
  530. Of course, many numbers in your local area code are still long
  531. distance.  FONDIR will attempt to read a file called LDAREA.xxx,
  532. where 'xxx' is the three digit local area code.  Each exchange in the
  533. LDAREA.xxx file is assumed to be not local, but long distance.
  534. Since I don't know all the long distance areas and phone exchanges, I
  535. leave it up to you to make your own LDAREA.xxx files, if you need
  536. them.  Just make sure you use the same format that the METRO.xxx files
  537. use, ie. one three digit code per line.
  538.  
  539. Here's an example :  You live in the 214 area code, and you have a
  540. BBS list like this --
  541.  
  542. |d5   |n20                 |#12          |p4
  543.  
  544. 03/24 MY BBS               214-881-2627  #Z
  545. 03/24 Joe's BBS            214-555-1234  #Z
  546. 03/24 RBBS Central         900-555-0000  #Y
  547.  
  548. You also have a file called LDAREA.214 that contains two lines :
  549.  
  550. 555
  551. 666
  552.  
  553. When you use the /l:214 and /a:1- options, FONDIR will create phone
  554. numbers that look like this :
  555.  
  556. 1 MY BBS               881-2627
  557. 2 Joe's BBS            1-214-555-1234
  558. 3 RBBS Central         1-900-555-0000
  559.  
  560. Why ?  The first entry was 214-881 and 881 is NOT in the LDAREA.214
  561. file, so it must be local.  FONDIR stripped the area code.  The
  562. second entry was 214-555 and 555 IS in the LDAREA.214 ( remember this
  563. is just an example ).  555 then must be long distance, so FONDIR
  564. prefixed the number using the 1- code.  The third entry is area code
  565. 900 and in not involved with this type of translation.
  566.  
  567. On export, FONDIR will add back the area code to any phone number
  568. which is 8 digits or less, prior to writing to the BBS list file, if
  569. you use the /l: and /a: options.
  570.  
  571.  
  572. ┌───────────────────────────────────────────────────────────────────────┐
  573. │ PREFIX PHONE NUMBER ( /a:  option ).                                  │
  574. └───────────────────────────────────────────────────────────────────────┘
  575.   
  576.  
  577. The phone numbers in a BBS list may not always be fully dialable
  578. phone numbers.  Some examples of this are 'local 7 digit numbers'
  579. which are not local to you, incomplete phone numbers which are not
  580. stand alone numbers, or when you need to use access codes before you
  581. dial the number, such as the standard 1+ access code.
  582.  
  583. The /a: option, only works on Long Distance numbers outside your
  584. local area code as specified by the /l: option, unless the additional
  585. LDAREA.xxx file has been used.
  586.  
  587. Use /a:  followed by one or more prefix digit codes.  For example,
  588. you need to dial 10288-1- to get the correct long distance carrier :
  589. use /a:10288-1-  to prefix every LD phone number in the BBS list.
  590.  
  591. Most people with standard 10 digit phone lists will use :
  592.   /a:1-
  593.  
  594. The prefix is not recommended for PBX ( dial 9 to get out ) type
  595. functions.  In these cases, where ALL your phone numbers must be
  596. prefixed, use your Comm Program's dialing prefix feature, or set your
  597. modem dial string to something like ATDT9,  which causes every phone
  598. number to begin with the 9.
  599.  
  600.  
  601. ┌───────────────────────────────────────────────────────────────────────┐
  602. │ METRO NUMBER ( /d: option )                                           │
  603. └───────────────────────────────────────────────────────────────────────┘
  604.   
  605.  
  606. The files METRO.214 and METRO.817 contain sample exchange code
  607. listings.  The sample represents the 214 and 817 area codes.  Each
  608. file can contain none, one or up to 50 'exchange' codes.
  609.   
  610. An exchange is the first three digits of a 7 digit number.  Certain
  611. areas of the country allow callers to dial 'toll free' calls with
  612. 10 digits, ie. using the area code, but not the 1+ format.  These
  613. extended area calls are typically called Metro numbers.
  614.  
  615. FONDIR looks for a METRO.xxx file.   The 'xxx' is changed to the
  616. area code digits you specify in the /d: option.
  617.  
  618. If FONDIR finds such a file in the current directory, it will enable
  619. the logic to determine from your /d: option ( a metro area ) and
  620. the /a: option ( the long distance prefix ), whether or not a number
  621. is truly long distance, a metro number, or a local phone call, and
  622. how to encode the number correctly for dialing.
  623.  
  624. Since I don't know all the metro areas and phone exchanges, I leave
  625. it up to you to make your own METRO.xxx files, if you need them.  Just
  626. make sure you use the same format that the files are in now, ie. one
  627. three digit code per line.  You must insure that the 'xxx' extension
  628. matches your /d:xxx code.
  629.  
  630. An example :  You live in the 214 area code and you can dial some 817
  631. area code numbers without dialing 1 first.  Your BBS list looks like
  632. this :
  633.  
  634. |d5   |n20                 |#12          |p4
  635.  
  636. 03/24 MY BBS               214-881-2627  #Z
  637. 03/24 Joe's BBS            817-100-1234  #Z
  638. 03/24 RBBS Central         817-555-0000  #Y
  639.  
  640. You have a file called METRO.817 that contains two lines :
  641.  
  642. 555
  643. 666
  644.  
  645. When you use the /d:817 and /a:1- options, FONDIR will create phone
  646. numbers that look like this :
  647.  
  648. 1 MY BBS               1-214-881-2627
  649. 2 Joe's BBS            1-817-100-1234
  650. 3 RBBS Central         817-555-0000
  651.  
  652. Why ?  Well the first entry was just like the example used in the /l:
  653. option description, but I didn't specify a /l: option !  The second
  654. entry is 817-100, but 100 is not in the METRO.817 file, so FONDIR
  655. translates it as a long distance number.  The third entry is 817-555,
  656. and 555 IS in the METRO.817 file, so FONDIR knows its a metro type
  657. number and does not prefix it with the 1- digits.
  658.  
  659.  
  660. ┌───────────────────────────────────────────────────────────────────────┐
  661. │ NOTES ON /l, /a, /d OPTIONS                                           │
  662. └───────────────────────────────────────────────────────────────────────┘
  663.   
  664.  
  665. The use of '-' dash characters is pretty much the norm for a phone
  666. number.  They are transparent to your modem ( yes, you probably send
  667. dashes to your modem all the time ).  You will note that I have
  668. demonstrated the /l, /a, and /d options using the '-' dash symbols.
  669.   
  670. If your particular BBS list format does not use dashes, then you
  671. should not use them in your option parameters.
  672.  
  673. On the off chance that your BBS list format uses the space ' '
  674. character for a separator, you will have to code the options in a
  675. special way, using quotes around the whole option.
  676.  
  677. For example :   "/l:214 "
  678.  
  679. Note the trailing space after the 214 digits.  This coding format
  680. would be used when your phone numbers look like this : 214 881 2627,
  681. instead of like this : 214-881 2627.
  682.  
  683. Because of restrictions imposed by the logic in FONDIR's phone number
  684. functions, only '-' dash or ' ' space or no separator code at all may
  685. be used.  You may use any of these three choices, at any time, but no
  686. other separator codes are useable.
  687.  
  688.  
  689. ┌───────────────────────────────────────────────────────────────────────┐
  690. │ FORMAT SPECIFICATION KEY CHARACTER ( /c  option ).                    │
  691. └───────────────────────────────────────────────────────────────────────┘
  692.   
  693.  
  694. The Format Specification is a text line that you must place in your
  695. BBS List file.  The Format Specification marks the data columns for
  696. the information fields in each entry.  The default character is the
  697. '|' character.  You may use any marker character by selecting it with
  698. the /c: option, and by using that character within your BBS list
  699. file.
  700.  
  701. See Chapter 7 for more information on the Format Specification and
  702. which programs support which fields.
  703.  
  704.  
  705. ┌───────────────────────────────────────────────────────────────────────┐
  706. │ MODEM SPEED ( /m  and /b  options )                                   │
  707. └───────────────────────────────────────────────────────────────────────┘
  708.   
  709.  
  710. The /m option allows you to specify your modems maximum speed.  For
  711. example, if you have a 2400 bps modem, and your BBS list contains
  712. entries with faster rates, you must use the /m:2  option so that
  713. FONDIR will set the rates for the faster entries back to 2400 bps.
  714.  
  715. The /b option allows you to set ALL entries to a specified speed. 
  716. This is useful for 'locking' your modem rate to a fixed speed,
  717. regardless of the speed of the modem at the other end, or the
  718. connected rate.
  719.  
  720. See Chapter 11 for the valid Speed Codes.
  721.  
  722.  
  723. ┌───────────────────────────────────────────────────────────────────────┐
  724. │ EXPORT ( /x  option )                                                 │
  725. └───────────────────────────────────────────────────────────────────────┘
  726.   
  727.  
  728. The /x option can be used in one of two formats :
  729.   1) /x =  with default Comm Program directory name assummed, or
  730.   2) /x:dirname = specified Comm Program directory name.
  731.  
  732. If you use the /x option with no directory name, FONDIR export
  733. assumes the standard Comm Program directory name, and that file must
  734. be located in the current subdirectory.
  735.  
  736. If you use the /x:dirname option, and specify the directory name,
  737. that file must also be located in the current directory.  Further,
  738. you may NOT specify a drive, path or file extension in the 'dirname'
  739. field.
  740.  
  741. Even though you specify the directory FILENAME, the EXTENSION is
  742. assummed.  This is because certain Comm Programs follow naming
  743. conventions with the directory file name, and/or auxilary or
  744. secondary file name.
  745.  
  746. Example using BOYA1.FON :
  747.  
  748.   fondir bbs.lst /o:b /x:boya1
  749.   
  750.  
  751. You can use the /c, /l, /d, /k and /s options with the Export
  752. ( /x ) option.
  753.  
  754. The BBS list filename is mandatory, and must contain a Format
  755. Specification as is the /o: option.
  756.  
  757. See Chapter 3 for more information on Export.
  758.  
  759.  
  760.  
  761. ╔═══════════════════════════════════════════════════════════════════════╗
  762. ║ 6 -- FONDIR DOS COMMAND SYNTAX EXAMPLES                               ║
  763. ╚═══════════════════════════════════════════════════════════════════════╝
  764.  
  765. >FONDIR bbslist.txt /o:b /s
  766.  
  767.    Import into Boyan from bbslist.txt, using system type for script
  768. name.
  769.  
  770. >FONDIR bbslist.txt /o:+ /b:a
  771.  
  772.    Import into procomm plus, make all speeds 19200.
  773.  
  774. >FONDIR bbslist.txt /o:+ /b:a /l:214
  775.  
  776.    Import, local area code is 214.  LDAREA.214 may contain
  777. exchanges in the 214 area which are still long distance to me.
  778.  
  779. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1-
  780.  
  781.    As above, long distance prefix is 1-.
  782.  
  783. >FONDIR bbslist.txt /o:+ /b:a /l:214 /a:1- /d:817
  784.  
  785.    As above, a metro area is 817.  METRO.817 may contain exchanges in
  786. the 817 area which are still local calls to me.  Most people will use
  787. the /l, /a, /d options all the time if they live in a long distance
  788. or metro area.
  789.  
  790. >FONDIR bbslist.txt /o:+ /m:2
  791.  
  792.    Import into procomm plus from bbslist.txt, max speed of my
  793. modem is 2400.
  794.  
  795. >FONDIR bbslist.txt /o:q /k
  796.  
  797.    Import into qmodem from bbslist.txt, use the date from the list.
  798.  
  799. >FONDIR bbslist.txt /o:g /p:O
  800.    
  801.    Import into gt-powercomm, default file transfer protocol is 'O'.
  802.  
  803. >FONDIR bbslist.txt /o:p /x
  804.  
  805.    Export from procomm 2.4 to bbslist.txt.
  806.  
  807. >FONDIR bbslist.txt /o:b /x:boya1
  808.  
  809.    Export from a specified boyan 4 phone file to bbslist.txt.
  810.  
  811. Yes, you can use this command :
  812.  
  813. FONDIR bbslist.txt /o:+ /b:a /m:a /l:214 /d:817 /a:10777-1- /k /p:Z
  814.  
  815.    The above command Imports from the text file bbslist.txt into
  816. procomm plus format.  All modem speeds are set to 19200.  My area
  817. code is 214 and I have a metro area 817.  Both my LDAREA.214 and
  818. METRO.817 files are present. True long distance calls will use the
  819. 10777-1- prefix.  I want to stuff the date from the bbslist.txt file
  820. into procomm plus, and I want the default file transfer protocols to
  821. be 'Z' type.
  822.  
  823.  
  824. ┌───────────────────────────────────────────────────────────────────────┐
  825. │ TRANSFORM EXAMPLE.                                                    │
  826. └───────────────────────────────────────────────────────────────────────┘
  827.   
  828.  
  829. FONDIR bbs.txt /o:q /l:214 /a:1- /d:817 /k /x
  830. FONDIR bbs.txt /o:b /l:214 /a:1- /d:817 /k
  831.  
  832.   The above two commands will export from qmodem format, writing
  833. the text file bbs.txt and import that text file into Boyan format.
  834. The file bbs.txt must exist and contain a Format Specification.
  835.  
  836.  
  837. ┌───────────────────────────────────────────────────────────────────────┐
  838. │ ERROR CHECKING OF INPUT ( SEMANTIC ).                                 │
  839. └───────────────────────────────────────────────────────────────────────┘
  840.   
  841.  
  842. FONDIR pretty much validates everything you enter, and it HAS to be
  843. valid or FONDIR will generate a message, usually telling you ( by
  844. re-displaying your input ) the part which FONDIR did not understand.
  845.  
  846.  
  847. ┌───────────────────────────────────────────────────────────────────────┐
  848. │ ERROR ON INPUT ( LOGICAL ).                                           │
  849. └───────────────────────────────────────────────────────────────────────┘
  850.   
  851.  
  852. FONDIR does not know what protocol letter you need to use, so it
  853. allows you to input any character.  FONDIR will ignore otherwise
  854. valid options which can not be implemented for a particular Comm
  855. Program.
  856.  
  857.  
  858.  
  859.  
  860. ╔═══════════════════════════════════════════════════════════════════════╗
  861. ║ 7 -- BBS LIST FORMAT SPECIFICATIONS                                   ║
  862. ╚═══════════════════════════════════════════════════════════════════════╝
  863.  
  864. Most any BBS list can be supported.  What FONDIR is looking for in
  865. the text list file is a Format Specification which tells FONDIR where
  866. the information fields are for each entry.
  867.  
  868. YOU MUST SUPPLY THE FORMAT SPECIFICATION, if it is not already in the
  869. BBS List file you are working with.
  870.  
  871. The Format Specification works best with columnar ( readable )
  872. fields, arranged with one list entry per text line.
  873.  
  874. As an example, here is the format of a full featured BBS list.  Note
  875. that the following text lines are longer than 80 characters, so an 80
  876. column display or printer will not allow you to see it as a single
  877. line.  But it IS a single line, and you should obtain a text editor
  878. that supports line lengths greater than 80 characters if you want all
  879. the information available all the time.
  880.  
  881. |n32                              |f4  |i8      |#15          |p4  |c5   |t5   |m8
  882.  
  883. MY BBS Henry Clark                OPUS 124/119  214-881-2627  2U Z 04/21 23:31 PASSWORD
  884. MY Other BBS Henry Clark          OPUS          214-555-1212  9U Z 04/21 23:42 PASSWORD
  885. Joe's Board                       TBBS          212-999-9999  AU Z 04/21 23:31 PASSWORD
  886. Ed's Mobile BBS                   QUIC 124/120  805-555-5555  9H Z                              
  887.  
  888. The first line is the Format Specification.  The remaining lines are
  889. BBS List entries.  Note that each '|' character is placed directly
  890. above the start of column data in the list entry. Some entries do not
  891. have all available data, that's ok.  Most Comm Programs do not
  892. support all the fields.  That's OK too.
  893.  
  894. Your BBS list file MUST contain a Format Specification.  This
  895. includes the file that you will EXPORT to.  A brand new Export file
  896. will have to contain the one line of Format Specification, as this is
  897. the only place FONDIR will look for it.
  898.  
  899. WARNING :  Inconsistent results occur when the text line length is
  900. less than the format specification position.  Make sure that empty
  901. columns of data are SPACE FILLED out to the end of the format
  902. specification.  FONDIR export does this on export.
  903.  
  904.  
  905. ┌───────────────────────────────────────────────────────────────────────┐
  906. │ FORMAT SPECIFICATION CODING                                           │
  907. └───────────────────────────────────────────────────────────────────────┘
  908.   
  909.  
  910. Each field contains three parts, all of which are required.  They are :
  911.  
  912.     Field-separator Code Length
  913.  
  914. '|' is the default field separator key.  It appears in the same
  915. column as the applicable list entry data.  Think of it as a marker
  916. or position indicator.  You can use any character by selecting the
  917. /c:  option on the FONDIR command line.
  918.  
  919. Code is one of the field codes listed below.
  920.  
  921. Length number is a decimal value from 2 to 255.
  922.  
  923. The field codes are :
  924.  
  925.  n - BBS Name, any ascii characters
  926.  i - ID or Info, additional description of BBS
  927.  # - Dial Digits, 0-9, -, etc.
  928.  p - Protocol Modifier Codes, see protocol codes below.
  929.  d - Last Call Date, mm/dd/yy
  930.  t - Last Call Time, hh:mi:ss
  931.  f - Script File name
  932.  g - Log File name
  933.  w - Password
  934.  e - Emulation type, such as ANSI or VT100
  935.  c - Call count
  936.  o - Hours of operation, when the BBS is available
  937.  h - elapsed hours online
  938.  m - elapsed minutes online
  939.  $ - elapsed total hours online
  940.  r - uploads received count
  941.  x - downloads transmitted count
  942.  @ - comm port, first character 0 ( default ), 1 or 2
  943.  y - city code
  944.  ( - dialing script
  945.  
  946. For example,   |n32
  947.  
  948.   means the following :
  949.  
  950. the | character is positional, it shows where the column containing
  951. the BBS name is located.  The n character, specifies that this is the
  952. BBS name.  The 32 is the total length of the BBS name field.
  953.  
  954.  
  955. ┌───────────────────────────────────────────────────────────────────────┐
  956. │ FORMAT SPECIFIER STACKING                                             │
  957. └───────────────────────────────────────────────────────────────────────┘
  958.   
  959.  
  960. If a column of BBS list data is to be used as more than one field,
  961. you may 'stack' the specifiers behind a single | character.  For
  962. example, suppose you want a script file ( |f option ) to be the
  963. first four characters of the BBS name ( |n option ).  Stack the
  964. format specifiers like this :
  965.  
  966. |n32f4                                 |#15          |p4  |c5   |t5   |m8
  967.  
  968. OPUS MY BBS Henry Clark                214-881-2627  2U Z 04/21 23:31 PASSWORD
  969. OPUS MY Other BBS Henry Clark          214-555-1212  9U Z 04/21 23:42 PASSWORD
  970. TBBS Joe's Board                       212-999-9999  AU Z 04/21 23:31 PASSWORD
  971. QUIC Ed's Mobile BBS                   805-555-5555  9H Z
  972.  
  973.  
  974. WARNING : Do not use a width longer than the actual width of the
  975. column of data.  This is important for both import and export.  A
  976. larger width specification will result in 'spill' from the next
  977. column of data into this column, and will cause extra ( usually
  978. unwanted ) data to be placed in your Comm Program directory file.
  979.  
  980.  
  981. ┌───────────────────────────────────────────────────────────────────────┐
  982. │ FORMAT FIRST WORD LENGTH                                              │
  983. └───────────────────────────────────────────────────────────────────────┘
  984.  
  985.  
  986. Some of the Comm Program directory fields specify file names.  These
  987. include :
  988.  
  989.    |f - Script File
  990.    |l - Log File
  991.    |( - Dialing Script File
  992.  
  993. It is not useful to have a file name with a space character it.  For
  994. example, |f8 on the field "OPUS MY BBS", would normally generate a
  995. script file named "OPUS MY ", which is not valid file name.
  996.  
  997. To avoid these problems, FONDIR automatically translates only the
  998. first whole word of the BBS list field for the above three format
  999. keys.  The field length in the format key becomes a maximum length,
  1000. and not a specific length.
  1001.  
  1002. "OPUS MY BBS" using |f8 translates to "OPUS", the first word, and a
  1003. useful script file name.  "PCBOARD Joe's BBS" using |f4 translates to
  1004. "PCBO", since the maximum length is 4.
  1005.  
  1006.  
  1007. ┌───────────────────────────────────────────────────────────────────────┐
  1008. │ FORMAT HEADER SPECIFICATION                                           │
  1009. └───────────────────────────────────────────────────────────────────────┘
  1010.   
  1011.  
  1012.  l - long distance area code
  1013.  
  1014. During processing of the BBS list file, FONDIR will look for the
  1015. |l characters in the first column of each line.  If this is found,
  1016. FONDIR looks further in the line for an Area Code of three digits.
  1017. If the area code is found, FONDIR assumes that this area code applies
  1018. to all subsequent phone number entries until a new |l is found.
  1019.  
  1020. For example :
  1021.  
  1022. |d5   |n20                 |#12          |p2 
  1023.  
  1024. 03/24 MY BBS               214-881-2627  #Z
  1025. 03/24 MY BBS               214-881-2627  #Z
  1026. 03/24 MY BBS               214-881-2627  #Z
  1027.  
  1028. could be listed as :
  1029.  
  1030. |d5   |n20                 |#12      |p2 
  1031.  
  1032. |L Dallas 214
  1033. 03/24 MY BBS               881-2627  #Z
  1034. 03/24 MY BBS               881-2627  #Z
  1035. 03/24 MY BBS               881-2627  #Z
  1036.  
  1037. This encoding format is useful when the BBS list entries are very
  1038. wide.
  1039.  
  1040. FONDIR does not support this convention on export to the BBS list
  1041. file.
  1042.  
  1043.  
  1044. ┌───────────────────────────────────────────────────────────────────────┐
  1045. │ COMM PROGRAM FIELD SUPPORT                                            │
  1046. └───────────────────────────────────────────────────────────────────────┘
  1047.   
  1048.  
  1049. The following list shows which format key fields are used by each of
  1050. the supported programs.  You may specify a field in your BBS list,
  1051. that is not supported by your Comm Program.
  1052.  
  1053. Boyan 4.0
  1054.   name                - |n
  1055.   phone               - |#
  1056.   script              - |f
  1057.   speed               - |p
  1058.   parity              - |p
  1059.   file protocol       - |p
  1060.   terminal emulation  - |e
  1061.   last date called    - |d and /k option
  1062. Procomm 2.4.3
  1063.   name                - |n
  1064.   phone               - |#
  1065.   script              - |f
  1066.   speed               - |p
  1067.   parity              - |p
  1068.   data bits           - |p
  1069. Procomm Plus 1.1
  1070.   name                - |n
  1071.   phone               - |#
  1072.   script              - |f
  1073.   speed               - |p
  1074.   parity              - |p
  1075.   data bits           - |p
  1076.   file protocol       - |p
  1077.   terminal emulation  - |e
  1078.   last date called    - |d and /k option
  1079.   call count          - |c
  1080. Qmodem 4.2
  1081.   name                - |n
  1082.   phone               - |#
  1083.   script              - |f
  1084.   speed               - |p
  1085.   parity              - |p
  1086.   data bits           - |p
  1087.   file protocol       - |p
  1088.   last date called    - |d and /k option
  1089.   password            - |w
  1090.   call count          - |c
  1091. GT-Powercomm 15.50
  1092.   name                - |n
  1093.   phone               - |#
  1094.   script              - |f
  1095.   speed               - |p
  1096.   parity              - |p
  1097.   data bits           - |p
  1098.   file protocol       - |p
  1099.   terminal emulation  - |e
  1100.   last date called    - |d and /k option
  1101.   last time called    - |t and /k option
  1102.   password            - |w
  1103.   call count          - |c
  1104.   hours of operation  - |o
  1105.   elapsed hours online  - |h
  1106.   elapsed minutes online- |m
  1107.   uploads received      - |r
  1108.   downloads transmitted - |x
  1109.   comment 1             - |i
  1110.   city code             - |y
  1111.   dialing script        - |(
  1112. Telix 3.11
  1113.   name                - |n
  1114.   phone               - |#
  1115.   script              - |f
  1116.   speed               - |p
  1117.   parity              - |p
  1118.   data bits           - |p
  1119.   file protocol       - |p
  1120.   terminal emulation  - |e
  1121.   last date called    - |d and /k option
  1122.   password            - |w
  1123.   call count          - |c
  1124. Pibterm 4.1
  1125.   name                - |n
  1126.   phone               - |#
  1127.   script              - |f
  1128.   speed               - |p
  1129.   parity              - |p
  1130.   data bits           - |p
  1131.   file protocol       - |p
  1132.   terminal emulation  - |e
  1133.   last date called    - |d and /k option
  1134.   last time called    - |t and /k option
  1135. Telemate 2.0
  1136.   name                - |n
  1137.   phone               - |#
  1138.   script              - |f
  1139.   logfile             - |g
  1140.   comm port           - |@
  1141.   speed               - |p
  1142.   parity              - |p
  1143.   data bits           - |p
  1144.   file protocol       - |p
  1145.   terminal emulation  - |e
  1146.   last date called    - |d and /k option
  1147.   password            - |w
  1148.   call count          - |c
  1149.   auxilary MEMO file  - |i
  1150. PC-Talk4 1.39
  1151.   name                - |n
  1152.   phone               - |#
  1153.   speed               - |p
  1154.   parity              - |p
  1155.   data bits           - |p
  1156. Rcomm 2.1
  1157.   name                - |n
  1158.   phone               - |#
  1159.   speed               - |p
  1160.   parity              - |p
  1161.   data bits           - |p
  1162. K9-Express 8.6
  1163.   name                - |n
  1164.   phone               - |#
  1165.   script              - |f
  1166.   speed               - |p
  1167.   parity              - |p
  1168.   data bits           - |p
  1169.   file protocol       - |p
  1170.   last date called    - |d and /k option
  1171.   last time called    - |t and /k option
  1172. Mirror 3 1.01
  1173.   name                - |n
  1174.   phone               - |#
  1175.   script              - |f
  1176.   speed               - |p
  1177.   parity              - |p
  1178.   data bits           - |p
  1179.   terminal emulation  - |e
  1180.   last date called    - |d and /k option
  1181.   last time called    - |t and /k option
  1182.   call count          - |c
  1183.   elapsed time online - |h
  1184.   total time online   - |$
  1185.   comment 1           - |i
  1186. PC Anywhere 3.11
  1187.   name                - |n
  1188.   phone               - |#
  1189.   logfile             - |g   ( simply Y or N )
  1190. Carbon Copy Plus 4.01
  1191.   name                - |n
  1192.   phone               - |#
  1193.   password            - |w
  1194. A Dialer 2.0
  1195.   name                - |n
  1196.   phone               - |#
  1197.   script              - |f
  1198.   password            - |w
  1199.   last date called    - |d and /k option
  1200.   city code           - |y
  1201. Commo 4.3
  1202.   name                - |n
  1203.   phone               - |#
  1204.   macro               - |f
  1205.   password            - |w
  1206.   last date called    - |d and /k option
  1207.   
  1208.  
  1209.  
  1210. ╔═══════════════════════════════════════════════════════════════════════╗
  1211. ║ 8 -- BBS LIST CONTENTS                                                ║
  1212. ╚═══════════════════════════════════════════════════════════════════════╝
  1213.  
  1214. ┌───────────────────────────────────────────────────────────────────────┐
  1215. │ PROTOCOL FIELD FORMAT                                                 │
  1216. └───────────────────────────────────────────────────────────────────────┘
  1217.   
  1218.  
  1219. The protocol field is specially coded, and contains several
  1220. characters of information, including modem speed, parity, file
  1221. transfer protocol and modem type.
  1222.  
  1223. Some examples :
  1224.  
  1225. |p5
  1226. 2 EX
  1227.  
  1228. The above specifies a 2400 bps, Even parity connection using Xmodem
  1229. for a file transfer protocol.
  1230.  
  1231. |p5
  1232. BZ
  1233.  
  1234. The above specifies 38400 bps and Zmodem protocol.
  1235.  
  1236.  
  1237. The protocol modifier codes are described in the following sections.
  1238. Support for protocol modifiers will be based on these lists.
  1239. Trademarks and Copyrights exists for several of the names included below.
  1240.  
  1241.  
  1242. ┌───────────────────────────────────────────────────────────────────────┐
  1243. │ THE BPS MODEM RATE.                                                   │
  1244. └───────────────────────────────────────────────────────────────────────┘
  1245.   
  1246.  
  1247. ! or 3       - 300 bps
  1248. @ or 1       - 1200 bps
  1249. # or 2       - 2400 bps  ( the default )
  1250. 4            - 4800 bps
  1251. ^ or 9       - 9600 bps
  1252. a or A       - 19200 bps
  1253. 8 or b or B  - 38400 bps
  1254. c or C       - 57600 bps
  1255. d or D       - 115200 bps
  1256.  
  1257. ┌───────────────────────────────────────────────────────────────────────┐
  1258. │ MODEM TYPE                                                            │
  1259. └───────────────────────────────────────────────────────────────────────┘
  1260.   
  1261.  
  1262. This field is reserved but presently not used by any Comm Program.
  1263.  
  1264. U  - U.S. Robotics (T) modem
  1265. H  - Hayes (T) modem
  1266. F  - Fastcomm (T) modem
  1267. T  - Trailblazer (T) modem
  1268. V  - any V.32 modem
  1269.  
  1270. ┌───────────────────────────────────────────────────────────────────────┐
  1271. │ PARITY INDICATOR.                                                     │
  1272. └───────────────────────────────────────────────────────────────────────┘
  1273.   
  1274.  
  1275. e or E - Even parity
  1276.  
  1277. ┌───────────────────────────────────────────────────────────────────────┐
  1278. │ FILE TRANSFER PROTOCOL TYPE.                                          │
  1279. └───────────────────────────────────────────────────────────────────────┘
  1280.   
  1281.  
  1282. The following are only a few of the many available.
  1283.  
  1284. Z - Zmodem
  1285. X - Xmodem
  1286. Y - Ymodem
  1287. K - Kermit
  1288. I - Imodem
  1289. G - Ymodem-G
  1290. T - Telink
  1291. S - CLink
  1292. 7 - Modem 7
  1293.  
  1294. ┌───────────────────────────────────────────────────────────────────────┐
  1295. │ TERMINAL EMULATOR MODE CODES                                          │
  1296. └───────────────────────────────────────────────────────────────────────┘
  1297.   
  1298.  
  1299. The following are the supported terminal emulator codes.
  1300.  
  1301. TT   - TTY
  1302. AN   - ANSI
  1303. VT   - VT100
  1304. TV   - Televideo
  1305. HE   - Heath
  1306. AD   - AD
  1307. 31   - Model 31
  1308. 32   - Model 32
  1309. WY   - Wyse
  1310.  
  1311.  
  1312. Register if you want custom BBS list translations.
  1313.  
  1314.  
  1315. ┌───────────────────────────────────────────────────────────────────────┐
  1316. │ Examples of BBS Lists                                                 │
  1317. └───────────────────────────────────────────────────────────────────────┘
  1318.   
  1319.  
  1320. A few BBS list Format Specifications are presented for examples. 
  1321. Many of these are longer than 80 characters.
  1322.  
  1323. Darwin National BBS List :
  1324. |#12                                         |f1  |p2     |n20
  1325.  
  1326. IFNA Nodelist ( use COMCOL /m:15 /c:; to convert to vertical column format ) :
  1327.                |n15                                               |#15             |p1
  1328.  
  1329. XLATLIST Text Output of Nodelist :
  1330.                 |n20                 |#14                                  |p1
  1331.  
  1332. Carr/Farmer Dallas/Ft. Worth BBS List :
  1333. |d5   |n29f8                        |#8      |p8      |i23
  1334. |L area code header
  1335.  
  1336.  
  1337.  
  1338. ╔═══════════════════════════════════════════════════════════════════════╗
  1339. ║ 9 -- PROGRAM SWITCHES AND DEFAULTS                                    ║
  1340. ╚═══════════════════════════════════════════════════════════════════════╝
  1341.  
  1342. The default protocol is 'Z', Zmodem.
  1343.  
  1344. The default bps rate is 2400 bps (2).
  1345.  
  1346. The default maximum rate is 38400 (b).
  1347.  
  1348. The default I/O port number is 0 ( not COM1, Telemate only ).
  1349.  
  1350. The default Format Specification Field Separator key character is
  1351. '|'.
  1352.  
  1353. The default last date called is blank ( today's date, Qmodem only ).
  1354.  
  1355. The maximum line length of a BBS text file is 255 characters.
  1356.  
  1357.  
  1358. ┌───────────────────────────────────────────────────────────────────────┐
  1359. │ Comm Program Type Codes                                               │
  1360. └───────────────────────────────────────────────────────────────────────┘
  1361.   
  1362. Here are the valid program type codes used in the /o:   parameter.
  1363.  
  1364. 'B'     Boyan 4.0
  1365. 'P'     Procomm 2.4.3
  1366. '+'     Procomm Plus 1.1
  1367. 'Q'     Qmodem 4.2
  1368. 'G'     GT-Powercomm 15.50
  1369. 'T'     Telix 3.11
  1370. 'I'     Pibterm 4.1
  1371. 'M'     Telemate 2.0
  1372. 'C'     PC-Talk4 1.39
  1373. 'R'     Rcomm 2.1
  1374. 'K'     K9 Express 8.6
  1375. 'O'     Mirror 3 1.01
  1376. 'A'     PC Anywhere 3.11
  1377. 'Y'     Carbon Copy Plus 4.01
  1378. 'D'     A Dialer 2.0
  1379. 'F'     Commo 4.3
  1380.  
  1381. Upper or lower case letters are acceptable.  As you can see, I'm
  1382. running out of matching letters <grin>.
  1383.  
  1384. If you don't use something, you will see an error message.  The Comm
  1385. Program type field is REQUIRED.  You can use an upper or lower case
  1386. letter to specify your Comm Program.
  1387.  
  1388.  
  1389.  
  1390. ┌───────────────────────────────────────────────────────────────────────┐
  1391. │ Speed Code Parameters                                                 │
  1392. └───────────────────────────────────────────────────────────────────────┘
  1393.  
  1394.  
  1395. The valid speed codes for use with the /m: amd /b: parameters are :
  1396.  
  1397. 3       - 300 bps
  1398. 1       - 1200 bps
  1399. 2       - 2400 bps  ( the default )
  1400. 4       - 4800 bps
  1401. 9       - 9600 bps
  1402. A       - 19200 bps
  1403. B       - 38400 bps
  1404. C       - 57600 bps   ( not currently supported )
  1405. D       - 115200 bps  ( not currently supported )
  1406.  
  1407. Upper and lower case letters are acceptable.
  1408.  
  1409.  
  1410. ┌───────────────────────────────────────────────────────────────────────┐
  1411. │ Warnings and Other Notes                                              │
  1412. └───────────────────────────────────────────────────────────────────────┘
  1413.   
  1414.  
  1415. GT 15.50 modifies the phone directory header record after every
  1416. use of the program. FONDIR sets the phone directory header to the same
  1417. values generated by use of the GT_UTIL program.
  1418.  
  1419.  
  1420. ╔═══════════════════════════════════════════════════════════════════════╗
  1421. ║ 10 -- REGISTER TO GET UPDATES                                         ║
  1422. ╚═══════════════════════════════════════════════════════════════════════╝
  1423.  
  1424. Print out this following page. Write a check. Address an envelope.
  1425. Mail it.  You will feel really good when you get my response.
  1426.  
  1427.  
  1428.  
  1429. ╔═══════════════════════════════════════════════════════════════════════╗
  1430.  
  1431.   FONDIR Phone List Translator Utility Registration Form and
  1432.   Payment Invoice #900701 for Version 5.5
  1433.  
  1434.   
  1435.   Name    ───────────────────────────────────────
  1436.   
  1437.   Address ───────────────────────────────────────
  1438.   
  1439.           ───────────────────────────────────────
  1440.   
  1441.           ───────────────────────────────────────
  1442.   
  1443.   Phone   ───────────────────────────────────────
  1444.   
  1445.   
  1446.   Version ────────────────  Date Received ────────────────
  1447.   
  1448.   
  1449.   Check one :
  1450.   
  1451.   (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies
  1452.   
  1453.         at U.S. 20 Dollars each.
  1454.   
  1455.   (  )  Enclosed is U.S. ──────────── Dollars for ─────────── copies
  1456.   
  1457.         of customized versions at U.S. 50 Dollars each.
  1458.   
  1459.         Enter customization parameters : ───────────────────────────────
  1460.   
  1461.         ────────────────────────────────────────────────────────────────
  1462.   
  1463.         ────────────────────────────────────────────────────────────────
  1464.   
  1465.   (  )  Enclosed is U.S.  400        Dollars for  20 or more  copies
  1466.   
  1467.         on a site license ( make your own copies, documents ).
  1468.   
  1469.   Send this form with check or money order,
  1470.   payable to Hershel Enterprises, Inc. to :
  1471.   
  1472.     Software Mechanics, FONDIR
  1473.     P.O. Box 832052
  1474.     Richardson, TX 75083-2052
  1475.     U.S.A.
  1476.   
  1477. ╚═══════════════════════════════════════════════════════════════════════╝
  1478.  
  1479.  
  1480.  
  1481. ╔═══════════════════════════════════════════════════════════════════════╗
  1482. ║ 11 -- LICENSE AGREEMENT                                               ║
  1483. ╚═══════════════════════════════════════════════════════════════════════╝
  1484.  
  1485. The SOFTWARE is FONDIR, the Phone Directory Translate Utility,
  1486. Copyright (C) 1988-1990 Henry C. Clark, Hershel Enterprises, Inc.
  1487.  
  1488.   By using or distributing, or allowing to be distributed the
  1489. SOFTWARE, you are agreeing to be bound by the terms of this
  1490. agreement.
  1491.  
  1492.   If you do not agree to the terms of this agreement, promptly
  1493. destroy any and all copies of the SOFTWARE that you may have.
  1494.  
  1495. ┌───────────────────────────────────────────────────────────────────────┐
  1496. │ The Terms of this Agreement :                                         │
  1497. └───────────────────────────────────────────────────────────────────────┘
  1498.  
  1499. 1
  1500.    You may NOT accept money, or otherwise charge a fee for the
  1501. SOFTWARE because you transfer a copy of the SOFTWARE to another party. 
  1502. You may NOT alter the SOFTWARE files, nor distribute the files using
  1503. a file name other than that name which you received.  The SOFTWARE
  1504. may be compressed using different techniques, only if all the
  1505. component files of the original package are included.  You may NOT
  1506. decompile, reverse engineer or include the SOFTWARE in another work.
  1507.  
  1508. 2
  1509.    You may NOT accept money, or otherwise charge a fee for ANY medium
  1510. upon which the SOFTWARE is transferred, including but not limited to
  1511. modem carrier, diskettes, CD-ROM, magnetic tape, etc. without written
  1512. permission from Hershel Enterprises, Inc.
  1513.  
  1514. 3
  1515.    You may NOT use or distribute the Software in ANY manner for or by
  1516. commercial or governmental entities without first correctly filling
  1517. out and sending the registration agreement and payment.
  1518.  
  1519. 4
  1520.    You accept and understand that NO warranty is expressed or implied.
  1521. The person using the SOFTWARE bears all risk as to the quality and
  1522. performance of the SOFTWARE.   In no event shall Hershel Enterprises'
  1523. liability for any damages ever exceed the price paid for the license
  1524. to use the SOFTWARE, regardless of the form of the claim, even if
  1525. Hershel Enterprises has been notified of such a possibility.
  1526.  
  1527. 5
  1528.    You MAY distribute freely the Software within the above
  1529. restrictions.  You may use the Software on a trial basis, and you are
  1530. required to pay for the Software if you use it on a regular basis.
  1531.  
  1532.  
  1533. ┌───────────────────────────────────────────────────────────────────────┐
  1534. │ Note from the Author :                                                │
  1535. └───────────────────────────────────────────────────────────────────────┘
  1536.   
  1537.  
  1538. As the task of keeping up with the latest Comm Programs increases,
  1539. take time to reflect on the effort expended to produce this program.
  1540.  
  1541. When you run this program, watch how fast it finishes.  This program
  1542. is not the type you run everyday, but it will save you countless
  1543. hours of manual data entry, and open up the door to the BBS world
  1544. for you.
  1545.  
  1546. When you fill out the registration slip, write a check and use an
  1547. envelope, you ensure that improvements are made before you need
  1548. them.  My compilers, software tools, PCs, modems and especially
  1549. my time are not free.
  1550.  
  1551.